package com.expert.miniapp.dao;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 仪器设备数据访问层接口
 * 提供仪器设备相关的数据库操作方法
 */
@Mapper
public interface InstrumentMapper {

    /**
     * 根据仪器设备ID查询详情
     * @param instrumentId 仪器设备ID
     * @return 仪器设备详情，如果不存在则返回null
     */
    Instrument findById(@Param("instrumentId") String instrumentId);

    /**
     * 根据设备分类查询仪器设备列表
     * @param category 设备分类
     * @return 符合分类条件的仪器设备列表
     */
    List<Instrument> findByCategory(@Param("category") String category);

    /**
     * 查询所有仪器设备
     * @return 所有仪器设备列表
     */
    List<Instrument> findAll();

    /**
     * 按权重排序查询仪器设备列表（用于推荐）
     * @return 按权重随机排序的仪器设备列表
     */
    List<Instrument> findByWeightOrder();

    /**
     * 模糊搜索仪器设备
     * @param keyword 搜索关键词
     * @return 匹配关键词的仪器设备列表
     */
    List<Instrument> searchByKeyword(@Param("keyword") String keyword);

    /**
     * 根据分类统计仪器设备数量
     * @param category 分类名称（如："人工智能"）
     * @return 包含该分类的仪器设备数量
     */
    Integer countByCategory(@Param("category") String category);
}